home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 1 Issue 2 / PDCD-1 - Issue 02.iso / _editors / editors / _templed / !TEMPLED / TECHDOCS < prev    next >
Text File  |  1994-03-08  |  12KB  |  246 lines
  1. Version history
  2. ---------------
  3.  
  4. 1.28 Bugs fixed:
  5.       . Got error on startup when support for WimpExt was in Options file
  6.      Additions:
  7.       . Archive 'StyleGuide' in the 'Extras' directory, contains example
  8.         templates from the RiscOS 3 Style Guide
  9.       . New set of standard icons (in the 3D templates) by Neil Spellings.
  10.         These conform to the Style Guide and are suited for a future version
  11.         of the Wimp. Neil also provided an overview of the standard icons
  12.         as listed in the Style Guide (see the file 'NewIcons' in the
  13.         'StyleGuide' archive)
  14.       . Statistics window: choice of decimal/hex numbers saved in options
  15.         file
  16.  
  17. 1.27 Bugs fixed:
  18.       . Deleting icons by dragging them outside a window had stopped
  19.         working (since v. 1.24)
  20.       . Gave error when trying to edit title bar with outline font in it
  21.       . Corrected calculation of minimum icon size for text+sprite icons
  22.         with empty text string
  23.      Additions:
  24.       . Fast resizing of work area, with Ctrl+Alt+Adjust
  25.  
  26. 1.26 NOTE: For this version the source code has been left out of the
  27.         distribution, because the archive was getting rather large.
  28.         (From version 1.27 on, the source is distributed separately.)
  29.      Bugs fixed:
  30.       . Decreased minimum size of drag-box when resizing icons. Old
  31.         minimum (16x32) made it difficult to create sliders.
  32.      Additions:
  33.       . Added support for the WimpExt module. Like the Interface and AEH
  34.         module, this contains a number of extensions to the Wimp (3D
  35.         buttons, pointer change), plus a lot of other support for Wimp
  36.         applications.
  37.       . Can use the OLESupport module: changes in the file with custom
  38.         sprites (e.g. with !Paint) are signalled by the module; TemplEd
  39.         then re-loads the sprite file. (So you don't need to select
  40.         'Re-load' from the menu)
  41.  
  42. 1.25 Bugs fixed:
  43.       . Move icons with cursor keys only (i.e. no drag) gave error if
  44.         you hadn't dragged any icons in the same window first
  45.       . Gave 'Mistake' when deleting a template (though deleting did work)
  46.       . 'Min size' on sprite icons: looks for sprite in Wimp area if not
  47.         found in custom area
  48.      Additions:
  49.       . 'Keep on Screen' and 'Ignore extent' window flags can be edited
  50.         (these flags are for RO3 only)
  51.       . 'Tidy icons' replaced by multiple options
  52.       . From Acorn's !NewLook: 3D sprites, and the BorderUtils module
  53.         (contains fix for the '3D-button bug')
  54.  
  55. 1.24 Bugs fixed:
  56.       . Font usage counting revised again. Version 1.23 might lose a font
  57.         while still in use for an icon, resulting in 'Illegal font handle'
  58.         error
  59.       . Incorrect PROC call within PROCsetworkarea. No one complained, so
  60.         apparently the line is rarely executed
  61.       . Gave an error if an icon resize-drag ended outside the template
  62.      Additions:
  63.       . Pressing the cursor keys moves the currently selected icons
  64.         (without needing to drag with Shift+Select)
  65.       . When editing multiple icons, you can now set just 1 aspect: click
  66.         with Menu on 'Update' or 'Update & Exit'; then choose which flags
  67.         you want to change. The other settings of the icons remain the same
  68.       . Menu items to View/Re-load/Reset the custom sprites. (The 'View'
  69.         item just Filer_Runs the sprite file; use 'Re-load' after editing
  70.         the sprites; 't would be nice if !Paint supported the External Edit
  71.         protocol...)
  72.       . (Due to popular demand:) Pointer changes above appropriate icons in
  73.         the Icon Edit and Window Edit windows (was: only if using the 3D
  74.         templates). Not for RiscOS 2
  75.       . To minimize the 'Max size' field, click with Adjust on the
  76.         'Max size' text icon (sets number to length of text + 1)
  77.      
  78. 1.23 Bugs fixed:
  79.       . PLEASE NOTE: Use of function keys in the Edit windows has changed:
  80.           F2 = Update
  81.           F3 = Update & Exit
  82.           F4 = Exit
  83.         F1 is for activating interactive help, be it !StrongHelp or RiscOS
  84.         !Help. (This also follows Acorn guidelines)
  85.       . If a drag-select ended with the pointer over another window, the
  86.         icons in that window were selected (instead of in the window where
  87.         the drag started ...)
  88.       . Input focus wasn't shown correctly for templates with 'Pane' bit set
  89.         (instead, the non-pane window that was last opened, was highlighted)
  90.       . Count of font usage not always correct; sometimes caused the
  91.         counting by the FontManager to be too high
  92.       . Extended icon info (via !Help) gave wrong ESG number
  93.      Additions:
  94.       . During icon move/resize, Icon info window shows coords of drag-box
  95.         (thanks to Paul Hobbs for showing that it can be done)
  96.         This means that for single icons you can see the new position and
  97.         size during the drag.
  98.       . Interactive help for Icon Edit and Window Edit windows: press F1
  99.         with pointer above a button, to get help on the flag that this
  100.         button represents (!StrongHelp and !TemplHlp must be loaded first)
  101.       . Double grid:
  102.           - 'Icon size' grid locks all corners of the icons
  103.           - 'Icon position' grid locks the bottomleft corner, leaving the
  104.             size unchanged
  105.       . 'Same size' for icon selections
  106.       . Cooperates in desktop save (RiscOS 3)
  107.       . TAB key can be used to move the caret in dialogue windows
  108. 1.22 Bugs fixed:
  109.       . Copying templates caused an error, due to a brilliant new bug in
  110.         version 1.21
  111.       . Better calculation of minimum icon size
  112.       . Revised renumbering of icon selection
  113.      Additions:
  114.       . Filer-like browser window
  115.       . Hotkeys for Align, Space Out and for Copy Up/Down/Left/Right
  116.       . When editing title bar, you can set its colours from the Icon
  117.         Edit window (was: from Window Edit window only)
  118.       . Pressing Esc during a drag aborts it
  119.       . Moving icons to other templates is equivalent to copying
  120.       . Prevents desktop shutdown if data is changed & not saved
  121.       . Menus over Edit windows (Button type, ESG, Font etc.) pop up
  122.         when ANY mouse button is pressed (was: only for Menu button)
  123. 1.21 Bugs fixed:
  124.       . Sprite area pointer of windows was not reset to 1 (Wimp area) when
  125.         saving
  126.       . Saving to other applications (via Wimp$Scrap) now properly supported
  127.         Now it is possible to exchange templates between 2 copies of TemplEd
  128.       . Another bug in Wimp_LoadTemplate (#$&$#%@!!!): it expects some
  129.         indirected data for an indirected non-text, non-sprite icon.
  130.         Although the indirected data is not used, it won't digest an
  131.         invalid pointer.
  132.      Additions:
  133.       . Uses DragASprite in save windows
  134.       . Hotkeys for some functions (^Z, ^X, ^C etc.)
  135.       . Windows can be centered to the screen
  136.       . Icons can be centered to the window
  137.       . Support for AEH module
  138.       . 'Minimize size' for icons
  139.       . Using cursor keys to move pointer now also works for moving/
  140.         resizing windows (when done using Ctrl+Select/Ctrl+Adjust)
  141.       . When loading a templates file called 'Templates', TemplEd
  142.         automatically loads the 'Sprites' file from same directory, if such
  143.         a file exists
  144.       . MaxFonts% limit removed: font menu can contain any number of font
  145.         families
  146.       . If browser window is closed, all template windows are closed, too
  147. 1.20 Bugs fixed:
  148.       . Templates with deleted, indirected icons were saved without any
  149.         indirected data; Wimp_LoadTemplate gave an error when reading this,
  150.         because it expects some indirected data. (Weird...)
  151.       . TemplEd's own templates may now contain outline fonts (including
  152.         the custom icons for the 'Create icon' submenu)
  153.       . Would not run together with Joris R÷lings !FontSelect utility; the
  154.         FontLister module did not like the way TemplEd (v1.11) reads the
  155.         font names.
  156.      Additions:
  157.       . Resizing of a selection of icons
  158.       . Reads 'Templates' and 'Sprites' file of an application when its icon
  159.         is dropped on the icon bar
  160.       . Renumbering of a selection of icons
  161.       . Moving the mouse pointer during icon move/resize: cursor keys move
  162.         the pointer 1 pixel, or 4 pixels when combined with the Shift key
  163.       . When creating standard icons (from the 'Create icon' submenu), you
  164.         can now create several icons with one click.
  165.         (NOTE: the way standard icons are defined has changed. If you
  166.         already have a set of custom icons, DON'T just copy them into the
  167.         Templates file. Read the section on customizing in the Manual.)
  168.       . Option 'Delete icons moved outside'
  169.       . Alternative sets of templates and sprites, with 3D look
  170.       . Possibility to resize icons when aligning
  171.       . Icon resizing now only in 1 dimension (x or y) at a time
  172.       . Double-click on icon, title bar or background opens the appropriate
  173.         Edit window
  174.       . Drag-selecting of templates in 'Templates' window
  175.       . Souped-up 'Templates' window: templates appear as sprite+name
  176.       . Direction (up/down/left/right) for copying of icons in menu
  177.       . Extended icon info, such as button type and validation string, is
  178.         sent to !Help (Acorn's interactive help application).
  179.       . Help files for !StrongHlp
  180.       . Possibility to set coordinates of topleft corner (min.X & max.Y) of
  181.         work area (were fixed to 0,0 in old version)
  182. 1.11 Removed automatic minimizing of WimpSlot at startup, since it seemed
  183.      to give problems with RiscOS 2
  184.      Grid size now adapts to mode changes
  185. 1.10 First distributed version
  186.  
  187. 1.00 Test version
  188.  
  189.  
  190. Known bugs
  191. ----------
  192.  
  193. * In some cases, you may find it difficult to click-select an icon:
  194.      - When its button type is 'Menu' (icon is deselected when pointer
  195.        moves away from the icon)
  196.      - When it has border type 'R5' in its validation string (icon is
  197.        deselected after a short delay)
  198.      - When the icon is shaded (no reaction to a click)
  199.      - When the icon is part of a selection group (ESG), and the 'Allow
  200.        adjust' flags are cleared (click-selecting with Adjust deselects
  201.        the other icons)
  202.   In all cases, you can drag-select the icon, or you can use 'Select all'
  203.   and deselect some other icons.
  204.  
  205. * Double-clicking on an icon to open the Icon Edit window does not work
  206. smoothly with all button types; the Wimp interferes with TemplEd's
  207. reactions to clicks. For the same reason, double-clicking on the title bar
  208. has the weird effect that the Icon Edit window is opened, and immediately
  209. the template window is re-opened on top. I have made the double-click thingy
  210. optional; if you don't like it, you can switch it off.
  211.  
  212.  
  213. Limitations
  214. -----------
  215.  
  216. * Limits on the number of templates and the number of icons per template.
  217. This can be changed by setting the variables MaxTemplates% and MaxIcons%.
  218. There is also a limit on the size of indirected data that is stored with a
  219. template. Current settings:
  220.     MaxTemplates% = 100
  221.     MaxIcons%     = 200
  222.     MaxIndirSize% = 8000
  223. Note: files contain only actual contents; an empty indirected string with
  224. max size of 1000 takes up 1 byte (the CR terminator) in the file.
  225.  
  226. * TemplEd can't handle indirected strings longer than 255 bytes. You can set
  227. the maximum length above this limit, but TemplEd can't put more than 255
  228. characters in a text area.
  229.  
  230. * You can't set the sprite area for each icon separately; all sprites in a
  231. template are read from the same area.
  232.  
  233. * TemplEd is a single-file editor...
  234.  
  235.  
  236. Possible future additions
  237. -------------------------
  238.  
  239. Future versions MAY have one or more of the following features:
  240.  
  241. * Show grid
  242. * Multi-file editing
  243. * Grouping of icons
  244. * Export templates as Text file    
  245. * On fatal error, save templates in <Wimp$ScrapDir>
  246.